Inter.Net 55-1

home *** CD-ROM | disk | FTP | other *** search

/ Inter.Net 55-1 / Inter.Net 55-1.iso / CBuilder / Setup / BCB / data.z / dplay.h < prev next >

Wrap

C/C++ Source or Header | 1998-02-09 | 39.8 KB | 1,069 lines

/*==========================================================================; * * Copyright (C) 1994-1996 Microsoft Corporation. All Rights Reserved. * * File: dplay.h * Content: DirectPlay include file * ***************************************************************************/ #ifndef __DPLAY_INCLUDED__ #define __DPLAY_INCLUDED__ #pragma option push -b #include <ole2.h> // for DECLARE_INTERFACE and HRESULT #define _FACDP 0x877 #define MAKE_DPHRESULT( code ) MAKE_HRESULT( 1, _FACDP, code ) #ifdef __cplusplus extern "C" { #endif /* * GUIDS used by DirectPlay objects */ DEFINE_GUID(IID_IDirectPlay2, 0x2b74f7c0, 0x9154, 0x11cf, 0xa9, 0xcd, 0x0, 0xaa, 0x0, 0x68, 0x86, 0xe3); DEFINE_GUID(IID_IDirectPlay2A,0x9d460580, 0xa822, 0x11cf, 0x96, 0xc, 0x0, 0x80, 0xc7, 0x53, 0x4e, 0x82); /**************************************************************************** * * DirectPlay Structures * * Various structures used to invoke DirectPlay. * ****************************************************************************/ #ifndef IDIRECTPLAY2_OR_GREATER typedef struct IDirectPlay FAR *LPDIRECTPLAY; #else typedef struct IUnknown FAR *LPDIRECTPLAY; #endif typedef struct IDirectPlay2 FAR *LPDIRECTPLAY2; typedef struct IDirectPlay2 FAR *LPDIRECTPLAY2A; typedef struct IDirectPlay2 IDirectPlay2A; /* * DPID * DirectPlay player and group ID */ typedef DWORD DPID, FAR *LPDPID; /* * DPID that system messages come from */ #define DPID_SYSMSG 0 /* * DPID representing all players in the session */ #define DPID_ALLPLAYERS 0 /* * DPCAPS * Used to obtain the capabilities of a DirectPlay object */ typedef struct { DWORD dwSize; // Size of structure, in bytes DWORD dwFlags; // DPCAPS_xxx flags DWORD dwMaxBufferSize; // Maximum message size, in bytes, for this service provider DWORD dwMaxQueueSize; // Obsolete. DWORD dwMaxPlayers; // Maximum players/groups (local + remote) DWORD dwHundredBaud; // Bandwidth in 100 bits per second units; // i.e. 24 is 2400, 96 is 9600, etc. DWORD dwLatency; // Estimated latency; 0 = unknown DWORD dwMaxLocalPlayers; // Maximum # of locally created players allowed DWORD dwHeaderLength; // Maximum header length, in bytes, on messages // added by the service provider DWORD dwTimeout; // Service provider's suggested timeout value // This is how long DirectPlay will wait for // responses to system messages } DPCAPS, FAR *LPDPCAPS; /* * This DirectPlay object is the session host. If the host exits the * session, another application will become the host and receive a * DPSYS_HOST system message. */ #define DPCAPS_ISHOST 0x00000002 /* * The service provider bound to this DirectPlay object can optimize * group messaging. */ #define DPCAPS_GROUPOPTIMIZED 0x00000008 /* * The service provider bound to this DirectPlay object can optimize * keep alives (see DPSESSION_KEEPALIVE) */ #define DPCAPS_KEEPALIVEOPTIMIZED 0x00000010 /* * The service provider bound to this DirectPlay object can optimize * guaranteed message delivery. */ #define DPCAPS_GUARANTEEDOPTIMIZED 0x00000020 /* * This DirectPlay object supports guaranteed message delivery. */ #define DPCAPS_GUARANTEEDSUPPORTED 0x00000040 /* * DPSESSIONDESC2 * Used to describe the properties of a DirectPlay * session instance */ typedef struct { DWORD dwSize; // Size of structure DWORD dwFlags; // DPSESSION_xxx flags GUID guidInstance; // ID for the session instance GUID guidApplication; // GUID of the DirectPlay application. // GUID_NULL for all applications. DWORD dwMaxPlayers; // Maximum # players allowed in session DWORD dwCurrentPlayers; // Current # players in session (read only) union { // Name of the session LPWSTR lpszSessionName; // Unicode LPSTR lpszSessionNameA; // ANSI }; union { // Password of the session (optional) LPWSTR lpszPassword; // Unicode LPSTR lpszPasswordA; // ANSI }; DWORD dwReserved1; // Reserved for future MS use. DWORD dwReserved2; DWORD dwUser1; // For use by the application DWORD dwUser2; DWORD dwUser3; DWORD dwUser4; } DPSESSIONDESC2, FAR *LPDPSESSIONDESC2; /* * LPCDPSESSIONDESC2 * A constant pointer to DPSESSIONDESC2 */ typedef const DPSESSIONDESC2 FAR *LPCDPSESSIONDESC2; /* * Applications cannot create new players in this session. */ #define DPSESSION_NEWPLAYERSDISABLED 0x00000001 /* * If the DirectPlay object that created the session, the host, * quits, then the host will attempt to migrate to another * DirectPlay object so that new players can continue to be created * and new applications can join the session. */ #define DPSESSION_MIGRATEHOST 0x00000004 /* * This flag tells DirectPlay not to set the idPlayerTo and idPlayerFrom * fields in player messages. This cuts two DWORD's off the message * overhead. */ #define DPSESSION_NOMESSAGEID 0x00000008 /* * This flag tells DirectPlay to not allow any new applications to * join the session. Applications already in the session can still * create new players. */ #define DPSESSION_JOINDISABLED 0x00000020 /* * This flag tells DirectPlay to detect when remote players * exit abnormally (e.g. their computer or modem gets unplugged) */ #define DPSESSION_KEEPALIVE 0x00000040 /* * This flag tells DirectPlay not to send a message to all players * when a players remote data changes */ #define DPSESSION_NODATAMESSAGES 0x00000080 /* * DPNAME * Used to hold the name of a DirectPlay entity * like a player or a group */ typedef struct { DWORD dwSize; // Size of structure DWORD dwFlags; // Not used. Must be zero. union { // The short or friendly name LPWSTR lpszShortName; // Unicode LPSTR lpszShortNameA; // ANSI }; union { // The long or formal name LPWSTR lpszLongName; // Unicode LPSTR lpszLongNameA; // ANSI }; } DPNAME, FAR *LPDPNAME; /* * LPCDPNAME * A constant pointer to DPNAME */ typedef const DPNAME FAR *LPCDPNAME; /**************************************************************************** * * Prototypes for DirectPlay callback functions * ****************************************************************************/ /* * Callback for IDirectPlay2::EnumSessions */ typedef BOOL (FAR PASCAL * LPDPENUMSESSIONSCALLBACK2)( LPCDPSESSIONDESC2 lpThisSD, LPDWORD lpdwTimeOut, DWORD dwFlags, LPVOID lpContext ); /* * This flag is set on the EnumSessions callback dwFlags parameter when * the time out has occurred. There will be no session data for this * callback. If *lpdwTimeOut is set to a non-zero value and the * EnumSessionsCallback function returns TRUE then EnumSessions will * continue waiting until the next timeout occurs. Timeouts are in * milliseconds. */ #define DPESC_TIMEDOUT 0x00000001 /* * Callback for IDirectPlay2::EnumPlayers * IDirectPlay2::EnumGroups * IDirectPlay2::EnumGroupPlayers */ typedef BOOL (FAR PASCAL *LPDPENUMPLAYERSCALLBACK2)( DPID dpId, DWORD dwPlayerType, LPCDPNAME lpName, DWORD dwFlags, LPVOID lpContext ); /* * Unicode callback for DirectPlayEnumerate * This callback prototype will be used if compiling * for Unicode strings */ typedef BOOL (FAR PASCAL * LPDPENUMDPCALLBACK)( LPGUID lpguidSP, LPWSTR lpSPName, DWORD dwMajorVersion, DWORD dwMinorVersion, LPVOID lpContext); /* * ANSI callback for DirectPlayEnumerate * This callback prototype will be used if compiling * for ANSI strings */ typedef BOOL (FAR PASCAL * LPDPENUMDPCALLBACKA)( LPGUID lpguidSP, LPSTR lpSPName, DWORD dwMajorVersion, DWORD dwMinorVersion, LPVOID lpContext); /* * API's */ #ifdef UNICODE #define DirectPlayEnumerate DirectPlayEnumerateW #else #define DirectPlayEnumerate DirectPlayEnumerateA #endif // UNICODE extern HRESULT WINAPI DirectPlayEnumerateA( LPDPENUMDPCALLBACKA, LPVOID ); extern HRESULT WINAPI DirectPlayEnumerateW( LPDPENUMDPCALLBACK, LPVOID ); extern HRESULT WINAPI DirectPlayCreate( LPGUID lpGUID, LPDIRECTPLAY *lplpDP, IUnknown *pUnk); /**************************************************************************** * * IDirectPlay2 (and IDirectPlay2A) Interface * ****************************************************************************/ #undef INTERFACE #define INTERFACE IDirectPlay2 DECLARE_INTERFACE_( IDirectPlay2, IUnknown ) { /*** IUnknown methods ***/ STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE; STDMETHOD_(ULONG,AddRef) (THIS) PURE; STDMETHOD_(ULONG,Release) (THIS) PURE; /*** IDirectPlay2 methods ***/ STDMETHOD(AddPlayerToGroup) (THIS_ DPID, DPID) PURE; STDMETHOD(Close) (THIS) PURE; STDMETHOD(CreateGroup) (THIS_ LPDPID,LPDPNAME,LPVOID,DWORD,DWORD) PURE; STDMETHOD(CreatePlayer) (THIS_ LPDPID,LPDPNAME,HANDLE,LPVOID,DWORD,DWORD) PURE; STDMETHOD(DeletePlayerFromGroup)(THIS_ DPID,DPID) PURE; STDMETHOD(DestroyGroup) (THIS_ DPID) PURE; STDMETHOD(DestroyPlayer) (THIS_ DPID) PURE; STDMETHOD(EnumGroupPlayers) (THIS_ DPID,LPGUID,LPDPENUMPLAYERSCALLBACK2,LPVOID,DWORD) PURE; STDMETHOD(EnumGroups) (THIS_ LPGUID,LPDPENUMPLAYERSCALLBACK2,LPVOID,DWORD) PURE; STDMETHOD(EnumPlayers) (THIS_ LPGUID,LPDPENUMPLAYERSCALLBACK2,LPVOID,DWORD) PURE; STDMETHOD(EnumSessions) (THIS_ LPDPSESSIONDESC2,DWORD,LPDPENUMSESSIONSCALLBACK2,LPVOID,DWORD) PURE; STDMETHOD(GetCaps) (THIS_ LPDPCAPS,DWORD) PURE; STDMETHOD(GetGroupData) (THIS_ DPID,LPVOID,LPDWORD,DWORD) PURE; STDMETHOD(GetGroupName) (THIS_ DPID,LPVOID,LPDWORD) PURE; STDMETHOD(GetMessageCount) (THIS_ DPID, LPDWORD) PURE; STDMETHOD(GetPlayerAddress) (THIS_ DPID,LPVOID,LPDWORD) PURE; STDMETHOD(GetPlayerCaps) (THIS_ DPID,LPDPCAPS,DWORD) PURE; STDMETHOD(GetPlayerData) (THIS_ DPID,LPVOID,LPDWORD,DWORD) PURE; STDMETHOD(GetPlayerName) (THIS_ DPID,LPVOID,LPDWORD) PURE; STDMETHOD(GetSessionDesc) (THIS_ LPVOID,LPDWORD) PURE; STDMETHOD(Initialize) (THIS_ LPGUID) PURE; STDMETHOD(Open) (THIS_ LPDPSESSIONDESC2,DWORD) PURE; STDMETHOD(Receive) (THIS_ LPDPID,LPDPID,DWORD,LPVOID,LPDWORD) PURE; STDMETHOD(Send) (THIS_ DPID, DPID, DWORD, LPVOID, DWORD) PURE; STDMETHOD(SetGroupData) (THIS_ DPID,LPVOID,DWORD,DWORD) PURE; STDMETHOD(SetGroupName) (THIS_ DPID,LPDPNAME,DWORD) PURE; STDMETHOD(SetPlayerData) (THIS_ DPID,LPVOID,DWORD,DWORD) PURE; STDMETHOD(SetPlayerName) (THIS_ DPID,LPDPNAME,DWORD) PURE; STDMETHOD(SetSessionDesc) (THIS_ LPDPSESSIONDESC2,DWORD) PURE; }; /**************************************************************************** * * IDirectPlay2 interface macros * ****************************************************************************/ #if !defined(__cplusplus) || defined(CINTERFACE) #define IDirectPlay2_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b) #define IDirectPlay2_AddRef(p) (p)->lpVtbl->AddRef(p) #define IDirectPlay2_Release(p) (p)->lpVtbl->Release(p) #define IDirectPlay2_AddPlayerToGroup(p,a,b) (p)->lpVtbl->AddPlayerToGroup(p,a,b) #define IDirectPlay2_Close(p) (p)->lpVtbl->Close(p) #define IDirectPlay2_CreateGroup(p,a,b,c,d,e) (p)->lpVtbl->CreateGroup(p,a,b,c,d,e) #define IDirectPlay2_CreatePlayer(p,a,b,c,d,e,f) (p)->lpVtbl->CreatePlayer(p,a,b,c,d,e,f) #define IDirectPlay2_DeletePlayerFromGroup(p,a,b) (p)->lpVtbl->DeletePlayerFromGroup(p,a,b) #define IDirectPlay2_DestroyGroup(p,a) (p)->lpVtbl->DestroyGroup(p,a) #define IDirectPlay2_DestroyPlayer(p,a) (p)->lpVtbl->DestroyPlayer(p,a) #define IDirectPlay2_EnableNewPlayers(p,a) (p)->lpVtbl->EnableNewPlayers(p,a) #define IDirectPlay2_EnumGroupPlayers(p,a,b,c,d,e) (p)->lpVtbl->EnumGroupPlayers(p,a,b,c,d,e) #define IDirectPlay2_EnumGroups(p,a,b,c,d) (p)->lpVtbl->EnumGroups(p,a,b,c,d) #define IDirectPlay2_EnumPlayers(p,a,b,c,d) (p)->lpVtbl->EnumPlayers(p,a,b,c,d) #define IDirectPlay2_EnumSessions(p,a,b,c,d,e) (p)->lpVtbl->EnumSessions(p,a,b,c,d,e) #define IDirectPlay2_GetCaps(p,a,b) (p)->lpVtbl->GetCaps(p,a,b) #define IDirectPlay2_GetMessageCount(p,a,b) (p)->lpVtbl->GetMessageCount(p,a,b) #define IDirectPlay2_GetGroupData(p,a,b,c,d) (p)->lpVtbl->GetGroupData(p,a,b,c,d) #define IDirectPlay2_GetGroupName(p,a,b,c) (p)->lpVtbl->GetGroupName(p,a,b,c) #define IDirectPlay2_GetPlayerAddress(p,a,b,c) (p)->lpVtbl->GetPlayerAddress(p,a,b,c) #define IDirectPlay2_GetPlayerCaps(p,a,b,c) (p)->lpVtbl->GetPlayerCaps(p,a,b,c) #define IDirectPlay2_GetPlayerData(p,a,b,c,d) (p)->lpVtbl->GetPlayerData(p,a,b,c,d) #define IDirectPlay2_GetPlayerName(p,a,b,c) (p)->lpVtbl->GetPlayerName(p,a,b,c) #define IDirectPlay2_GetSessionDesc(p,a,b) (p)->lpVtbl->GetSessionDesc(p,a,b) #define IDirectPlay2_Initialize(p,a) (p)->lpVtbl->Initialize(p,a) #define IDirectPlay2_Open(p,a,b) (p)->lpVtbl->Open(p,a,b) #define IDirectPlay2_Receive(p,a,b,c,d,e) (p)->lpVtbl->Receive(p,a,b,c,d,e) #define IDirectPlay2_Send(p,a,b,c,d,e) (p)->lpVtbl->Send(p,a,b,c,d,e) #define IDirectPlay2_SetGroupData(p,a,b,c,d) (p)->lpVtbl->SetGroupData(p,a,b,c,d) #define IDirectPlay2_SetGroupName(p,a,b,c) (p)->lpVtbl->SetGroupName(p,a,b,c) #define IDirectPlay2_SetPlayerData(p,a,b,c,d) (p)->lpVtbl->SetPlayerData(p,a,b,c,d) #define IDirectPlay2_SetPlayerName(p,a,b,c) (p)->lpVtbl->SetPlayerName(p,a,b,c) #define IDirectPlay2_SetSessionDesc(p,a,b) (p)->lpVtbl->SetSessionDesc(p,a,b) #else /* C++ */ #define IDirectPlay2_QueryInterface(p,a,b) (p)->QueryInterface(a,b) #define IDirectPlay2_AddRef(p) (p)->AddRef() #define IDirectPlay2_Release(p) (p)->Release() #define IDirectPlay2_AddPlayerToGroup(p,a,b) (p)->AddPlayerToGroup(a,b) #define IDirectPlay2_Close(p) (p)->Close() #define IDirectPlay2_CreateGroup(p,a,b,c,d,e) (p)->CreateGroup(a,b,c,d,e) #define IDirectPlay2_CreatePlayer(p,a,b,c,d,e,f) (p)->CreatePlayer(a,b,c,d,e,f) #define IDirectPlay2_DeletePlayerFromGroup(p,a,b) (p)->DeletePlayerFromGroup(a,b) #define IDirectPlay2_DestroyGroup(p,a) (p)->DestroyGroup(a) #define IDirectPlay2_DestroyPlayer(p,a) (p)->DestroyPlayer(a) #define IDirectPlay2_EnableNewPlayers(p,a) (p)->EnableNewPlayers(a) #define IDirectPlay2_EnumGroupPlayers(p,a,b,c,d,e) (p)->EnumGroupPlayers(a,b,c,d,e) #define IDirectPlay2_EnumGroups(p,a,b,c,d) (p)->EnumGroups(a,b,c,d) #define IDirectPlay2_EnumPlayers(p,a,b,c,d) (p)->EnumPlayers(a,b,c,d) #define IDirectPlay2_EnumSessions(p,a,b,c,d,e) (p)->EnumSessions(a,b,c,d,e) #define IDirectPlay2_GetCaps(p,a,b) (p)->GetCaps(a,b) #define IDirectPlay2_GetMessageCount(p,a,b) (p)->GetMessageCount(a,b) #define IDirectPlay2_GetGroupData(p,a,b,c,d) (p)->GetGroupData(a,b,c,d) #define IDirectPlay2_GetGroupName(p,a,b,c) (p)->GetGroupName(a,b,c) #define IDirectPlay2_GetPlayerAddress(p,a,b,c) (p)->GetPlayerAddress(a,b,c) #define IDirectPlay2_GetPlayerCaps(p,a,b,c) (p)->GetPlayerCaps(a,b,c) #define IDirectPlay2_GetPlayerData(p,a,b,c,d) (p)->GetPlayerData(a,b,c,d) #define IDirectPlay2_GetPlayerName(p,a,b,c) (p)->GetPlayerName(a,b,c) #define IDirectPlay2_GetSessionDesc(p,a,b) (p)->GetSessionDesc(a,b) #define IDirectPlay2_Initialize(p,a) (p)->Initialize(a) #define IDirectPlay2_Open(p,a,b) (p)->Open(a,b) #define IDirectPlay2_Receive(p,a,b,c,d,e) (p)->Receive(a,b,c,d,e) #define IDirectPlay2_Send(p,a,b,c,d,e) (p)->Send(a,b,c,d,e) #define IDirectPlay2_SetGroupData(p,a,b,c,d) (p)->SetGroupData(a,b,c,d) #define IDirectPlay2_SetGroupName(p,a,b,c) (p)->SetGroupName(a,b,c) #define IDirectPlay2_SetPlayerData(p,a,b,c,d) (p)->SetPlayerData(a,b,c,d) #define IDirectPlay2_SetPlayerName(p,a,b,c) (p)->SetPlayerName(a,b,c) #define IDirectPlay2_SetSessionDesc(p,a,b) (p)->SetSessionDesc(a,b) #endif /**************************************************************************** * * EnumPlayers API flags * ****************************************************************************/ /* * Enumerate all players in the current session */ #define DPENUMPLAYERS_ALL 0x00000000 /* * Enumerate only local (created by this application) players */ #define DPENUMPLAYERS_LOCAL 0x00000008 /* * Enumerate only remote (non-local) players */ #define DPENUMPLAYERS_REMOTE 0x00000010 /* * Enumerate groups along with the players */ #define DPENUMPLAYERS_GROUP 0x00000020 /* * Enumerate players in another session (must supply lpguidInstance) */ #define DPENUMPLAYERS_SESSION 0x00000080 /**************************************************************************** * * EnumSessions API flags * ****************************************************************************/ /* * Enumerate sessions which can be joined */ #define DPENUMSESSIONS_AVAILABLE 0x00000001 /* * Enumerate all sessions even if they can't be joined. */ #define DPENUMSESSIONS_ALL 0x00000002 /**************************************************************************** * * GetCaps and GetPlayerCaps API flags * ****************************************************************************/ /* * The latency returned should be for guaranteed message sending. * Default is non-guaranteed messaging. */ #define DPGETCAPS_GUARANTEED 0x00000001 /**************************************************************************** * * GetGroupData, GetPlayerData API flags * Remote and local Group/Player data is maintained separately. * Default is DPGET_REMOTE. * ****************************************************************************/ /* * Get the remote data (set by any DirectPlay object in * the session using DPSET_REMOTE) */ #define DPGET_REMOTE 0x00000000 /* * Get the local data (set by this DirectPlay object * using DPSET_LOCAL) */ #define DPGET_LOCAL 0x00000001 /**************************************************************************** * * Open API flags * ****************************************************************************/ /* * Join the session that is described by the DPSESSIONDESC2 structure */ #define DPOPEN_JOIN 0x00000001 /* * Create a new session as described by the DPSESSIONDESC2 structure */ #define DPOPEN_CREATE 0x00000002 /**************************************************************************** * * Receive API flags * Default is DPRECEIVE_ALL * ****************************************************************************/ /* * Get the first message in the queue */ #define DPRECEIVE_ALL 0x00000001 /* * Get the first message in the queue directed to a specific player */ #define DPRECEIVE_TOPLAYER 0x00000002 /* * Get the first message in the queue from a specific player */ #define DPRECEIVE_FROMPLAYER 0x00000004 /* * Get the message but don't remove it from the queue */ #define DPRECEIVE_PEEK 0x00000008 /**************************************************************************** * * Send API flags * ****************************************************************************/ /* * Send the message using a guaranteed send method. * Default is non-guaranteed. */ #define DPSEND_GUARANTEED 0x00000001 /* * Send the message high-priority. Move to front of * send queue of sender and the receive queue of the * receipient */ #define DPSEND_HIGHPRIORITY 0x00000002 /* * Application will be sending several more guaranteed messages to * this player so the service provider may want to optimize for this. * Implementation of this flag by a service provider is optional. */ #define DPSEND_OPENSTREAM 0x00000008 /* * The optimization requested by DPSEND_OPENSTREAM is no longer * needed. Resources allocated for DPSEND_OPENSTREAM may be released. */ #define DPSEND_CLOSESTREAM 0x00000010 /**************************************************************************** * * SetGroupData, SetGroupName, SetPlayerData, SetPlayerName, * SetSessionDesc API flags. * Default is DPSET_REMOTE. * ****************************************************************************/ /* * Propagate the data to all players in the session */ #define DPSET_REMOTE 0x00000000 /* * Do not propagate the data to other players */ #define DPSET_LOCAL 0x00000001 /* * Used with DPSET_REMOTE, use guaranteed message send to * propagate the data */ #define DPSET_GUARANTEED 0x00000002 /**************************************************************************** * * DirectPlay system messages and message data structures * * All system message come 'From' player DPID_SYSMSG. To determine what type * of message it is, cast the lpData from Receive to DPMSG_GENERIC and check * the dwType member against one of the following DPSYS_xxx constants. Once * a match is found, cast the lpData to the corresponding of the DPMSG_xxx * structures to access the data of the message. * ****************************************************************************/ /* * A new player or group has been created in the session * Use DPMSG_CREATEPLAYERORGROUP. Check dwPlayerType to see if it * is a player or a group. */ #define DPSYS_CREATEPLAYERORGROUP 0x0003 /* * A player has been deleted from the session * Use DPMSG_DESTROYPLAYERORGROUP */ #define DPSYS_DESTROYPLAYERORGROUP 0x0005 /* * A player has been added to a group * Use DPMSG_ADDPLAYERTOGROUP */ #define DPSYS_ADDPLAYERTOGROUP 0x0007 /* * A player has been removed from a group * Use DPMSG_DELETEPLAYERFROMGROUP */ #define DPSYS_DELETEPLAYERFROMGROUP 0x0021 /* * This DirectPlay object lost its connection with all the * other players in the session. * Use DPMSG_SESSIONLOST. */ #define DPSYS_SESSIONLOST 0x0031 /* * The current host has left the session. * This DirectPlay object is now the host. * Use DPMSG_HOST. */ #define DPSYS_HOST 0x0101 /* * The remote data associated with a player or * group has changed. Check dwPlayerType to see * if it is a player or a group * Use DPMSG_SETPLAYERORGROUPDATA */ #define DPSYS_SETPLAYERORGROUPDATA 0x0102 /* * The name of a player or group has changed. * Check dwPlayerType to see if it is a player * or a group. * Use DPMSG_SETPLAYERORGROUPNAME */ #define DPSYS_SETPLAYERORGROUPNAME 0x0103 /* * Used in the dwPlayerType field to indicate if it applies to a group * or a player */ #define DPPLAYERTYPE_GROUP 0x00000000 #define DPPLAYERTYPE_PLAYER 0x00000001 /* * DPMSG_GENERIC * Generic message structure used to identify the message type. */ typedef struct { DWORD dwType; // Message type } DPMSG_GENERIC, FAR *LPDPMSG_GENERIC; /* * DPMSG_CREATEPLAYERORGROUP * System message generated when a new player or group * created in the session with information about it. */ typedef struct { DWORD dwType; // Message type DWORD dwPlayerType; // Is it a player or group DPID dpId; // ID of the player or group DWORD dwCurrentPlayers; // current # players & groups in session LPVOID lpData; // pointer to remote data DWORD dwDataSize; // size of remote data DPNAME dpnName; // structure with name info } DPMSG_CREATEPLAYERORGROUP, FAR *LPDPMSG_CREATEPLAYERORGROUP; /* * DPMSG_DESTROYPLAYERORGROUP * System message generated when a player or group is being * destroyed in the session with information about it. */ typedef struct { DWORD dwType; // Message type DWORD dwPlayerType; // Is it a player or group DPID dpId; // player ID being deleted LPVOID lpLocalData; // copy of players local data DWORD dwLocalDataSize; // sizeof local data LPVOID lpRemoteData; // copy of players remote data DWORD dwRemoteDataSize; // sizeof remote data } DPMSG_DESTROYPLAYERORGROUP, FAR *LPDPMSG_DESTROYPLAYERORGROUP; /* * DPMSG_ADDPLAYERTOGROUP * System message generated when a player is being added * to a group. */ typedef struct { DWORD dwType; // Message type DPID dpIdGroup; // group ID being added to DPID dpIdPlayer; // player ID being added } DPMSG_ADDPLAYERTOGROUP, FAR *LPDPMSG_ADDPLAYERTOGROUP; /* * DPMSG_DELETEPLAYERFROMGROUP * System message generated when a player is being * removed from a group */ typedef DPMSG_ADDPLAYERTOGROUP DPMSG_DELETEPLAYERFROMGROUP; typedef DPMSG_DELETEPLAYERFROMGROUP FAR *LPDPMSG_DELETEPLAYERFROMGROUP; /* * DPMSG_SETPLAYERORGROUPDATA * System message generated when remote data for a player or * group has changed. */ typedef struct { DWORD dwType; // Message type DWORD dwPlayerType; // Is it a player or group DPID dpId; // ID of player or group LPVOID lpData; // pointer to remote data DWORD dwDataSize; // size of remote data } DPMSG_SETPLAYERORGROUPDATA, FAR *LPDPMSG_SETPLAYERORGROUPDATA; /* * DPMSG_SETPLAYERORGROUPNAME * System message generated when the name of a player or * group has changed. */ typedef struct { DWORD dwType; // Message type DWORD dwPlayerType; // Is it a player or group DPID dpId; // ID of player or group DPNAME dpnName; // structure with new name info } DPMSG_SETPLAYERORGROUPNAME, FAR *LPDPMSG_SETPLAYERORGROUPNAME; /* * DPMSG_HOST * System message generated when the host has migrated to this * DirectPlay object. * */ typedef DPMSG_GENERIC DPMSG_HOST; typedef DPMSG_HOST FAR *LPDPMSG_HOST; /* * DPMSG_SESSIONLOST * System message generated when the connection to the session is lost. * */ typedef DPMSG_GENERIC DPMSG_SESSIONLOST; typedef DPMSG_SESSIONLOST FAR *LPDPMSG_SESSIONLOST; /**************************************************************************** * * DIRECTPLAY ERRORS * * Errors are represented by negative values and cannot be combined. * ****************************************************************************/ #define DP_OK S_OK #define DPERR_ALREADYINITIALIZED MAKE_DPHRESULT( 5 ) #define DPERR_ACCESSDENIED MAKE_DPHRESULT( 10 ) #define DPERR_ACTIVEPLAYERS MAKE_DPHRESULT( 20 ) #define DPERR_BUFFERTOOSMALL MAKE_DPHRESULT( 30 ) #define DPERR_CANTADDPLAYER MAKE_DPHRESULT( 40 ) #define DPERR_CANTCREATEGROUP MAKE_DPHRESULT( 50 ) #define DPERR_CANTCREATEPLAYER MAKE_DPHRESULT( 60 ) #define DPERR_CANTCREATESESSION MAKE_DPHRESULT( 70 ) #define DPERR_CAPSNOTAVAILABLEYET MAKE_DPHRESULT( 80 ) #define DPERR_EXCEPTION MAKE_DPHRESULT( 90 ) #define DPERR_GENERIC E_FAIL #define DPERR_INVALIDFLAGS MAKE_DPHRESULT( 120 ) #define DPERR_INVALIDOBJECT MAKE_DPHRESULT( 130 ) #define DPERR_INVALIDPARAM E_INVALIDARG #define DPERR_INVALIDPARAMS DPERR_INVALIDPARAM #define DPERR_INVALIDPLAYER MAKE_DPHRESULT( 150 ) #define DPERR_NOCAPS MAKE_DPHRESULT( 160 ) #define DPERR_NOCONNECTION MAKE_DPHRESULT( 170 ) #define DPERR_NOMEMORY E_OUTOFMEMORY #define DPERR_OUTOFMEMORY DPERR_NOMEMORY #define DPERR_NOMESSAGES MAKE_DPHRESULT( 190 ) #define DPERR_NONAMESERVERFOUND MAKE_DPHRESULT( 200 ) #define DPERR_NOPLAYERS MAKE_DPHRESULT( 210 ) #define DPERR_NOSESSIONS MAKE_DPHRESULT( 220 ) #define DPERR_SENDTOOBIG MAKE_DPHRESULT( 230 ) #define DPERR_TIMEOUT MAKE_DPHRESULT( 240 ) #define DPERR_UNAVAILABLE MAKE_DPHRESULT( 250 ) #define DPERR_UNSUPPORTED E_NOTIMPL #define DPERR_BUSY MAKE_DPHRESULT( 270 ) #define DPERR_USERCANCEL MAKE_DPHRESULT( 280 ) #define DPERR_NOINTERFACE E_NOINTERFACE #define DPERR_CANNOTCREATESERVER MAKE_DPHRESULT( 290 ) #define DPERR_PLAYERLOST MAKE_DPHRESULT( 300 ) #define DPERR_SESSIONLOST MAKE_DPHRESULT( 310 ) #define DPERR_BUFFERTOOLARGE MAKE_DPHRESULT( 1000 ) #define DPERR_CANTCREATEPROCESS MAKE_DPHRESULT( 1010 ) #define DPERR_APPNOTSTARTED MAKE_DPHRESULT( 1020 ) #define DPERR_INVALIDINTERFACE MAKE_DPHRESULT( 1030 ) #define DPERR_NOSERVICEPROVIDER MAKE_DPHRESULT( 1040 ) #define DPERR_UNKNOWNAPPLICATION MAKE_DPHRESULT( 1050 ) #define DPERR_NOTLOBBIED MAKE_DPHRESULT( 1070 ) /**************************************************************************** * * dplay 1.0 obsolete structures + interfaces * Included for compatibility only. New apps should * use IDirectPlay2 * ****************************************************************************/ // define this to ignore obsolete interfaces and constants #ifndef IDIRECTPLAY2_OR_GREATER #define DPOPEN_OPENSESSION DPOPEN_JOIN #define DPOPEN_CREATESESSION DPOPEN_CREATE #define DPENUMSESSIONS_PREVIOUS 0x00000004 #define DPENUMPLAYERS_PREVIOUS 0x00000004 #define DPSEND_GUARANTEE DPSEND_GUARANTEED #define DPSEND_TRYONCE 0x00000004 #define DPCAPS_NAMESERVICE 0x00000001 #define DPCAPS_NAMESERVER DPCAPS_ISHOST #define DPCAPS_GUARANTEED 0x00000004 #define DPLONGNAMELEN 52 #define DPSHORTNAMELEN 20 #define DPSESSIONNAMELEN 32 #define DPPASSWORDLEN 16 #define DPUSERRESERVED 16 #define DPSYS_ADDPLAYER 0x0003 #define DPSYS_DELETEPLAYER 0x0005 #define DPSYS_DELETEGROUP 0x0020 #define DPSYS_DELETEPLAYERFROMGRP 0x0021 #define DPSYS_CONNECT 0x484b typedef struct { DWORD dwType; DWORD dwPlayerType; DPID dpId; char szLongName[DPLONGNAMELEN]; char szShortName[DPSHORTNAMELEN]; DWORD dwCurrentPlayers; } DPMSG_ADDPLAYER; typedef DPMSG_ADDPLAYER DPMSG_ADDGROUP; typedef struct { DWORD dwType; DPID dpIdGroup; DPID dpIdPlayer; } DPMSG_GROUPADD; typedef DPMSG_GROUPADD DPMSG_GROUPDELETE; typedef struct { DWORD dwType; DPID dpId; } DPMSG_DELETEPLAYER; typedef BOOL (PASCAL *LPDPENUMPLAYERSCALLBACK)( DPID dpId, LPSTR lpFriendlyName, LPSTR lpFormalName, DWORD dwFlags, LPVOID lpContext ); typedef struct { DWORD dwSize; GUID guidSession; DWORD dwSession; DWORD dwMaxPlayers; DWORD dwCurrentPlayers; DWORD dwFlags; char szSessionName[DPSESSIONNAMELEN]; char szUserField[DPUSERRESERVED]; DWORD dwReserved1; char szPassword[DPPASSWORDLEN]; DWORD dwReserved2; DWORD dwUser1; DWORD dwUser2; DWORD dwUser3; DWORD dwUser4; } DPSESSIONDESC,*LPDPSESSIONDESC; typedef BOOL (PASCAL * LPDPENUMSESSIONSCALLBACK)( LPDPSESSIONDESC lpDPSessionDesc, LPVOID lpContext, LPDWORD lpdwTimeOut, DWORD dwFlags); /* * IDirectPlay */ #undef INTERFACE #define INTERFACE IDirectPlay DECLARE_INTERFACE_( IDirectPlay, IUnknown ) { /*** IUnknown methods ***/ STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE; STDMETHOD_(ULONG,AddRef) (THIS) PURE; STDMETHOD_(ULONG,Release) (THIS) PURE; /*** IDirectPlay methods ***/ STDMETHOD(AddPlayerToGroup) (THIS_ DPID, DPID) PURE; STDMETHOD(Close) (THIS) PURE; STDMETHOD(CreatePlayer) (THIS_ LPDPID,LPSTR,LPSTR,LPHANDLE) PURE; STDMETHOD(CreateGroup) (THIS_ LPDPID,LPSTR,LPSTR) PURE; STDMETHOD(DeletePlayerFromGroup)(THIS_ DPID,DPID) PURE; STDMETHOD(DestroyPlayer) (THIS_ DPID) PURE; STDMETHOD(DestroyGroup) (THIS_ DPID) PURE; STDMETHOD(EnableNewPlayers) (THIS_ BOOL) PURE; STDMETHOD(EnumGroupPlayers) (THIS_ DPID, LPDPENUMPLAYERSCALLBACK,LPVOID,DWORD) PURE; STDMETHOD(EnumGroups) (THIS_ DWORD, LPDPENUMPLAYERSCALLBACK,LPVOID,DWORD) PURE; STDMETHOD(EnumPlayers) (THIS_ DWORD, LPDPENUMPLAYERSCALLBACK,LPVOID,DWORD) PURE; STDMETHOD(EnumSessions) (THIS_ LPDPSESSIONDESC,DWORD,LPDPENUMSESSIONSCALLBACK,LPVOID,DWORD) PURE; STDMETHOD(GetCaps) (THIS_ LPDPCAPS) PURE; STDMETHOD(GetMessageCount) (THIS_ DPID, LPDWORD) PURE; STDMETHOD(GetPlayerCaps) (THIS_ DPID, LPDPCAPS) PURE; STDMETHOD(GetPlayerName) (THIS_ DPID,LPSTR,LPDWORD,LPSTR,LPDWORD) PURE; STDMETHOD(Initialize) (THIS_ LPGUID) PURE; STDMETHOD(Open) (THIS_ LPDPSESSIONDESC) PURE; STDMETHOD(Receive) (THIS_ LPDPID,LPDPID,DWORD,LPVOID,LPDWORD) PURE; STDMETHOD(SaveSession) (THIS_ LPSTR) PURE; STDMETHOD(Send) (THIS_ DPID, DPID, DWORD, LPVOID, DWORD) PURE; STDMETHOD(SetPlayerName) (THIS_ DPID,LPSTR,LPSTR) PURE; }; /**************************************************************************** * * IDirectPlay interface macros * ****************************************************************************/ #if !defined(__cplusplus) || defined(CINTERFACE) #define IDirectPlay_AddPlayerToGroup(p,a,b) (p)->lpVtbl->AddPlayerToGroup(p,a,b) #define IDirectPlay_Close(p) (p)->lpVtbl->Close(p) #define IDirectPlay_CreateGroup(p,a,b,c) (p)->lpVtbl->CreateGroup(p,a,b,c) #define IDirectPlay_CreatePlayer(p,a,b,c,d) (p)->lpVtbl->CreatePlayer(p,a,b,c,d) #define IDirectPlay_DeletePlayerFromGroup(p,a,b) (p)->lpVtbl->DeletePlayerFromGroup(p,a,b) #define IDirectPlay_DestroyGroup(p,a) (p)->lpVtbl->DestroyGroup(p,a) #define IDirectPlay_DestroyPlayer(p,a) (p)->lpVtbl->DestroyPlayer(p,a) #define IDirectPlay_EnableNewPlayers(p,a) (p)->lpVtbl->EnableNewPlayers(p,a) #define IDirectPlay_EnumGroupPlayers(p,a,b,c,d) (p)->lpVtbl->EnumGroupPlayers(p,a,b,c,d) #define IDirectPlay_EnumGroups(p,a,b,c,d) (p)->lpVtbl->EnumGroups(p,a,b,c,d) #define IDirectPlay_EnumPlayers(p,a,b,c,d) (p)->lpVtbl->EnumPlayers(p,a,b,c,d) #define IDirectPlay_EnumSessions(p,a,b,c,d,e) (p)->lpVtbl->EnumSessions(p,a,b,c,d,e) #define IDirectPlay_GetCaps(p,a) (p)->lpVtbl->GetCaps(p,a) #define IDirectPlay_GetMessageCount(p,a,b) (p)->lpVtbl->GetMessageCount(p,a,b) #define IDirectPlay_GetPlayerCaps(p,a,b) (p)->lpVtbl->GetPlayerCaps(p,a,b) #define IDirectPlay_GetPlayerName(p,a,b,c,d,e) (p)->lpVtbl->GetPlayerName(p,a,b,c,d,e) #define IDirectPlay_Initialize(p,a) (p)->lpVtbl->Initialize(p,a) #define IDirectPlay_Open(p,a) (p)->lpVtbl->Open(p,a) #define IDirectPlay_Receive(p,a,b,c,d,e) (p)->lpVtbl->Receive(p,a,b,c,d,e) #define IDirectPlay_SaveSession(p,a) (p)->lpVtbl->SaveSession(p,a) #define IDirectPlay_Send(p,a,b,c,d,e) (p)->lpVtbl->Send(p,a,b,c,d,e) #define IDirectPlay_SetPlayerName(p,a,b,c) (p)->lpVtbl->SetPlayerName(p,a,b,c) #else /* C++ */ #define IDirectPlay_AddPlayerToGroup(p,a,b) (p)->AddPlayerToGroup(a,b) #define IDirectPlay_Close(p) (p)->Close() #define IDirectPlay_CreateGroup(p,a,b,c) (p)->CreateGroup(a,b,c) #define IDirectPlay_CreatePlayer(p,a,b,c,d) (p)->CreatePlayer(a,b,c,d) #define IDirectPlay_DeletePlayerFromGroup(p,a,b) (p)->DeletePlayerFromGroup(a,b) #define IDirectPlay_DestroyGroup(p,a) (p)->DestroyGroup(a) #define IDirectPlay_DestroyPlayer(p,a) (p)->DestroyPlayer(a) #define IDirectPlay_EnableNewPlayers(p,a) (p)->EnableNewPlayers(a) #define IDirectPlay_EnumGroupPlayers(p,a,b,c,d) (p)->EnumGroupPlayers(a,b,c,d) #define IDirectPlay_EnumGroups(p,a,b,c,d) (p)->EnumGroups(a,b,c,d) #define IDirectPlay_EnumPlayers(p,a,b,c,d) (p)->EnumPlayers(a,b,c,d) #define IDirectPlay_EnumSessions(p,a,b,c,d,e) (p)->EnumSessions(a,b,c,d,e) #define IDirectPlay_GetCaps(p,a) (p)->GetCaps(a) #define IDirectPlay_GetMessageCount(p,a,b) (p)->GetMessageCount(a,b) #define IDirectPlay_GetPlayerCaps(p,a,b) (p)->GetPlayerCaps(a,b) #define IDirectPlay_GetPlayerName(p,a,b,c,d,e) (p)->GetPlayerName(a,b,c,d,e) #define IDirectPlay_Initialize(p,a) (p)->Initialize(a) #define IDirectPlay_Open(p,a) (p)->Open(a) #define IDirectPlay_Receive(p,a,b,c,d,e) (p)->Receive(a,b,c,d,e) #define IDirectPlay_SaveSession(p,a) (p)->SaveSession(a) #define IDirectPlay_Send(p,a,b,c,d,e) (p)->Send(a,b,c,d,e) #define IDirectPlay_SetPlayerName(p,a,b,c) (p)->SetPlayerName(a,b,c) #endif DEFINE_GUID(IID_IDirectPlay, 0x5454e9a0, 0xdb65, 0x11ce, 0x92, 0x1c, 0x00, 0xaa, 0x00, 0x6c, 0x49, 0x72); #endif // IDIRECTPLAY2_OR_GREATER /**************************************************************************** * * IDirectPlay macros (included regardless of IDIRECTPLAY2_OR_GREATER flag) * ****************************************************************************/ #if !defined(__cplusplus) || defined(CINTERFACE) #define IDirectPlay_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b) #define IDirectPlay_AddRef(p) (p)->lpVtbl->AddRef(p) #define IDirectPlay_Release(p) (p)->lpVtbl->Release(p) #else #define IDirectPlay_QueryInterface(p,a,b) (p)->QueryInterface(a,b) #define IDirectPlay_AddRef(p) (p)->AddRef() #define IDirectPlay_Release(p) (p)->Release() #endif // IDirectPlay interface macros #ifdef __cplusplus }; #endif #pragma option pop #endif